home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / C / Concat-o-magic Folder / concat-o-magic Read Me < prev   
Encoding:
Text File  |  1990-03-07  |  7.8 KB  |  185 lines  |  [TEXT/QED1]
  1. concat-o-magic version 0.11ß
  2. Copyright © 1990 Chriss Koch.  All rights reserved.
  3.  
  4. concat-o-magic is a Tabby event compatible utility which concatenates TEXT
  5. files.  concat-o-magic was written in THINK C by Chriss Koch (some portions
  6. copyright THINK C and Michael Connick).  concat-o-magic is free for
  7. non-commercial use and distribution.  Please contact the author for details
  8. concerning commercial use or distribution.
  9.  
  10.  
  11. • USES •
  12. Most likely you already have an idea how you want to use this utility.
  13. In case you don't, I'll explain one of the ways I use it.
  14.  
  15. Daily I create TEXT file listings of each file section on my BBS.  I take
  16. these files, along with headers for each section, and squash it all into one
  17. file.
  18.  
  19. concat-o-magic is Tabby event compatible, which means that it can run
  20. unattended during any Tabby event.  concat-o-magic can also be operated
  21. outside of the Tabby event.
  22.  
  23.  
  24. • SETUP •
  25. When using concat-o-magic in a Tabby event, the application must reside in the
  26. same folder as your BBS and Tabby programs.  Of course you will need to edit
  27. any of your Tabby event chains where you would like concat-o-magic to run.
  28. concat-o-magic reads a TEXT file containing pathnames to find the files you
  29. wish to concatenate.  By default, this file’s name is “concat-o-magic data”
  30. and it resides in the same folder as concat-o-magic.  You may however specify
  31. a new name and location for the data file by modifying the first string in the
  32. STR# (ID 401) resource.  The second string in the STR# (ID 401) resource
  33. contains the pathname to a TEXT file which contains information concerning the
  34. activities of concat-o-magic.  This file’s default name is “concat-o-magic
  35. log” and it's location is in the same folder as concat-o-magic.  Here again,
  36. you may modify the name and location of this log file by editing the resource.
  37.  
  38. You will need to edit the concat-o-magic data file so that it contains valid
  39. pathnames to the files you wish to concatenate.  This data file of pathnames
  40. must adhere to a special format.  Each line of the data file should contain
  41. the pathname to a TEXT file.  Each pathname is limited to 255 characters in
  42. length.  Each line must be terminated in a Carriage Return.  The first line in
  43. the data file will contain the full pathname to your output file.  This output
  44. file is the product of concat-o-magic’s execution.  Each additional line in
  45. the data file should contain the full pathname to a file you wish to have
  46. concatenated (appended) to the output file.  Below is a sample concat-o-magic
  47. data file.
  48.  
  49. HD 60:concat-o-magic output:SCORPION PDS Files
  50. HD 60:PDS Files Folder:Applications.hdr
  51. HD 60:PDS Files Folder:Applications.txt
  52. HD 60:PDS Files Folder:Utilities.hdr
  53. HD 60:PDS Files Folder:Utilities.txt
  54. HD 60:PDS Files Folder:Games.hdr
  55. HD 60:PDS Files Folder:Games.txt
  56. HD 60:PDS Files Folder:Fonts.hdr
  57. HD 60:PDS Files Folder:Fonts.txt
  58.  
  59. Note that “HD 60:SCORPION PDS Files” would be the very first line in the data
  60. file, and it is the full pathname to the output file.  If the output file
  61. already exists, it will not be overwritten unless specified (See OPTIONS below
  62. for more information).
  63. The second line, “HD 60:PDS Files Folder:Applications.hdr”, contains the full
  64. pathname to the first input file.  The contents of this file will constitute
  65. the beginning of the output file.  Each successive line contains the full
  66. pathname to an input file.  Notice that all pathnames must be terminated in a
  67. Carriage Return (including the last pathname).  The input files are appended
  68. to the output file in the order that they appear.
  69.  
  70.  
  71. • OPTIONS •
  72. If the output file specified in the first line of the data file already exists
  73. (for example following execution of concat-o-magic), the file will not be
  74. overwritten, unless specified by you.  To take advantage of this option,
  75. simply place one (or more) TAB character(s), plus a 'y' or 'Y' character
  76. following the output file’s pathname, on the same line.  concat-o-magic also
  77. has the capability to delete the input files after they are appended to the
  78. output file, using this same technique.  This feature is especially useful if
  79. you don't have an abundance of free disk space.  Below is an example of this
  80. option. (this will line up properly if you have your TABs set to 4 characters)
  81.  
  82. HD 60:concat-o-magic output:SCORPION PDS Files    Y
  83. HD 60:PDS Files Folder:Applications.hdr            N
  84. HD 60:PDS Files Folder:Applications.txt            Y
  85. HD 60:PDS Files Folder:Utilities.hdr            N
  86. HD 60:PDS Files Folder:Utilities.txt            Y
  87. HD 60:PDS Files Folder:Games.hdr                N
  88. HD 60:PDS Files Folder:Games.txt                Y
  89. HD 60:PDS Files Folder:Fonts.hdr                N
  90. HD 60:PDS Files Folder:Fonts.txt                Y
  91.  
  92. In the above example, the output file will be overwritten, if it already
  93. exists.  The “Applications.txt”, “Utilities.txt”, “Games.txt” and “Fonts.txt”
  94. files will be deleted after they are appended to the output file.  The TAB and
  95. 'n' characters are not required, but may be used, to facilitate readability.
  96. Just be sure to put only one character after the last TAB on each line.
  97. Notice that I used multiple TABs, which makes everything line up nicely, but
  98. this is not a requirement.  Only one TAB is needed.
  99.  
  100. As mentioned previously, you may specify the names and locations of the data
  101. and log files by editing concat-o-magic’s STR# resource (ID 401).
  102.  
  103.  
  104. • DISCLAIMER •
  105. concat-o-magic is distributed “as is” with no warranty, express or implied
  106. with respect to the software or its quality, performance, reliability, or
  107. fitness for any purpose.  In no case will the author be held liable for direct
  108. or incidental damages resulting from defects in the software, including but
  109. not limited to any interruption of service, loss of business, anticipated
  110. profit, or other consequential damages.
  111.  
  112.  
  113. • MORE STUFF •
  114. This version of concat-o-magic is ßeta release.  concat-o-magic and other
  115. utilities may become available as a package some time in the future.  The
  116. latest version of concat-o-magic can always be obtained by downloading or file
  117. request (use filename concat-o-magic.sit to FREQ) from SCORPION BBS
  118. (719-637-1458, FidoNet node 1:128/46) or by sending a formatted diskette and
  119. self-addressed, stamped, return envelope to:
  120.  
  121.     Chriss Koch
  122.     5325 Red Sky Dr
  123.     Colo Spgs, CO 80915
  124.  
  125. The author of concat-o-magic would appreciate any comments (bug
  126. reports, enhancement requests (?), etc…) from users.  Please address all
  127. correspondence to the address above or:
  128.  
  129. GEnie: C.KOCH
  130.  
  131. SCORPION BBS
  132. 3/12/2400 24hrs
  133. (719) 637-1458
  134. FidoNet 1:128/46
  135. Sysop: Chriss Koch
  136.  
  137.  
  138. • A PLUG •
  139. Do you operate a Red Ryder Host (Second Sight) BBS?
  140.  
  141. Have you grown tired of the inflexibility of Scott Watson's file section
  142. editor, "FileEdit"?
  143.  
  144. Do you find yourself yearning for something a little less unwieldy?
  145.  
  146. Never fear, tidE is hear!
  147.  
  148. What is tidE, you ask?
  149.  
  150. tidE is a Red Ryder Host 2.x file section editor developed by Ken Beutel and
  151. myself.  tidE is a FREE program for non-commercial use and distribution by 
  152. Red Ryder Host sysops.  tidE is publicly available at fine BBSs near you.
  153.  
  154.  - or -
  155.  
  156. The latest version of tidE can always be obtained by downloading or file
  157. request (use filename tide.sit to FREQ) from SCORPION BBS (719-637-1458,
  158. FidoNet node 1:128/46) or by sending a formatted diskette and self-addressed,
  159. stamped, return envelope to the address shown above in “MORE STUFF”.
  160.  
  161. Some features of tidE include:
  162.  
  163. • Editing of multiple File Sections simultaneously (limited by RAM and
  164.   disk space).
  165. • Cut, Copy and Paste between File Sections.
  166. • Editing of file descriptions in a multiline environment (Cut, Copy and
  167.   Paste supported).
  168. • Online help.
  169. • Add new files with system and default parameters.
  170. • Multiple save features including removal of file entries marked for
  171.   deletion.
  172. • Full Mac interface support including windows, menus, mouse, cursor keys,
  173.   command key equivalents and short-cuts for commonly used commands.
  174. • Data extraction to TEXT file.
  175. • “Find” commands.
  176. • Sorting.
  177. • Printing.
  178. • And much more.
  179.  
  180.  
  181. Happy BBSing!
  182.  
  183. Chriss Koch
  184. “Sysops are some of the neatest people you’ll ever know!”
  185.